[General] section variables¶

Verbosity

Verbosity level of debugging (Default: 0)

Domain

The local NFSv4 domain name. An NFSv4 domain is a namespace with a unique username<->UID and groupname<->GID mapping. (Default: Host's fully-qualified DNS domain name)

No-Strip

In multi-domain environments, some NFS servers will append the identity management domain to the owner and owner_group in lieu of a true NFSv4 domain. This option can facilitate lookups in such environments. If set to a value other than "none", the nsswitch plugin will first pass the name to the password/group lookup function without stripping the domain off. If that mapping fails then the plugin will try again using the old method (comparing the domain in the string to the Domain value, stripping it if it matches, and passing the resulting short name to the lookup function). Valid values are "user", "group", "both", and "none". (Default: "none")

Reformat-Group

Winbind has a quirk whereby doing a group lookup in UPN format (e.g. staff@americas.example.com) will cause the group to be displayed prefixed with the full domain in uppercase (e.g. AMERICAS.EXAMPLE.COM\staff) instead of in the familiar netbios name format (e.g. AMERICAS\staff). Setting this option to true causes the name to be reformatted before passing it to the group lookup function in order to work around this. This setting is ignored unless No-Strip is set to either "both" or "group". (Default: "false")

Local-Realms

A comma-separated list of Kerberos realm names that may be considered equivalent to the local realm name. For example, users juser@ORDER.EDU and juser@MAIL.ORDER.EDU may be considered to be the same user in the specified Domain. (Default: the host's default realm name)
Note: If a value is specified here, the default local realm must be included as well.

[Mapping] section variables¶

Nobody-User

Local user name to be used when a mapping cannot be completed.

Nobody-Group

Local group name to be used when a mapping cannot be completed.

[Translation] section variables¶

Method

A comma-separated, ordered list of mapping methods (plug-ins) to use when mapping between NFSv4 names and local IDs. Each specified method is tried in order until a mapping is found, or there are no more methods to try. The methods included in the default distribution include "nsswitch", "umich_ldap", and "static". (Default: nsswitch)

GSS-Methods

An optional comma-separated, ordered list of mapping methods (plug-ins) to use when mapping between GSS Authenticated names and local IDs. (Default: the same list as specified for Method)

[Static] section variables¶

The "static" translation method uses a static list of GSS-Authenticated names to local user names. Entries in the list are of the form:

 principal@REALM = localusername

[UMICH_SCHEMA] section variables¶

If the "umich_ldap" translation method is specified, the following variables within the [UMICH_SCHEMA] section are used.

LDAP_server

LDAP server name or address (Required if using UMICH_LDAP)

LDAP_base

Absolute LDAP search base. (Required if using UMICH_LDAP)

LDAP_people_base

Absolute LDAP search base for people accounts. (Default: The LDAP_base value)

LDAP_group_base

Absolute LDAP search base for group accounts. (Default: The LDAP_base value)

LDAP_canonicalize_name

Whether or not to perform name canonicalization on the name given as LDAP_server (Default: "true")

LDAP_use_ssl

Set to "true" to enable SSL communication with the LDAP server. (Default: "false")

LDAP_ca_cert

Location of a trusted CA certificate used when SSL is enabled (Required if LDAP_use_ssl is true)

NFSv4_person_objectclass

The object class name for people accounts in your local LDAP schema (Default: NFSv4RemotePerson)

NFSv4_name_attr

Your local schema's attribute name to be used for NFSv4 user names (Default: NFSv4Name)

NFSv4_uid_attr

Your local schema's attribute name to be used for uidNumber (Default: uidNumber)

GSS_principal_attr

Your local schema's attribute name for GSSAPI Principal names (Default: GSSAuthName)

NFSv4_acctname_attr

Your local schema's attribute name to be used for account names (Default: uid)

NFSv4_group_objectclass

The object class name for group accounts in your local LDAP schema (Default: NFSv4RemoteGroup)

NFSv4_gid_attr

Your local schema's attribute name to be used for gidNumber (Default: gidNumber)

NFSv4_group_attr

Your local schema's attribute name to be used for NFSv4 group names (Default: NFSv4Name)

LDAP_use_memberof_for_groups

Some LDAP servers do a better job with indexing where searching through all the groups searching for the user in the memberuid list. Others like SunOne directory that search can takes minutes if there are thousands of groups. So setting LDAP_use_memberof_for_groups to true in the configuration file will use the memberof lists of the account and search through only those groups to obtain gids. (Default: false)

NFSv4_member_attr

If LDAP_use_memberof_for_groups is true, this is the attribute to be searched for. (Default: memberUid)

NFSv4_grouplist_filter

An optional search filter for determining group membership. (No Default)

LDAP_timeout_seconds

Number of seconds before timing out an LDAP request (Default: 4)